Add LootLocker Lifecycle Manager and Presence System

📋 Summary

This PR introduces a comprehensive service lifecycle management system and WebSocket-based presence functionality to the LootLocker Unity SDK. The changes establish a robust foundation for service coordination while adding real-time presence capabilities with platform-specific optimizations.

🎯 Key Features

LootLocker Lifecycle Manager

• Centralized Service Management: New LootLockerLifecycleManager coordinates all SDK services with proper initialization order and dependency management
• Service Architecture: Introduction of ILootLockerService interface for consistent service lifecycle patterns
• Thread-Safe Operations: All service access is thread-safe with proper locking mechanisms
• Unity Integration: Seamless Unity lifecycle event coordination (OnApplicationPause, OnApplicationFocus, OnApplicationQuit)

Event System

• Centralized Event Management: New LootLockerEventSystem provides typed, thread-safe event handling across the SDK
• Session Lifecycle Events: Comprehensive events for session started, refreshed, ended, expired, and local session changes
• Memory Safety: Weak reference-based event subscriptions prevent memory leaks
• Developer Experience: Strongly-typed event handlers with compile-time safety

Presence System

• Real-Time WebSocket Connectivity: LootLockerPresenceClient and LootLockerPresenceManager for real-time presence features
• Platform Support: Configurable platform enablement with recommended presets (Desktop + Console by default)
• Battery Optimization: Mobile-specific optimizations including configurable ping intervals and automatic pause/resume handling
• Connection Management: Automatic reconnection, latency tracking, and connection statistics
• Multi-Session Support: Concurrent presence connections for multiple player sessions

🔧 Technical Improvements

Performance Optimizations

• Cached Service References: RateLimiter reference cached in HTTPClient to eliminate service lookup overhead on every HTTP request
• Efficient Event Processing: Minimal allocation event system with automatic dead reference cleanup
• Connection Pooling: Proper WebSocket connection management with resource cleanup

Architecture Enhancements

• Service Dependencies: Clear initialization order (RateLimiter → HTTPClient → EventSystem → PresenceManager)
• Error Handling: Comprehensive error handling with actionable error messages throughout the stack
• State Management: Event-driven state management replacing direct state manipulation
• Resource Management: Proper cleanup and disposal patterns for all managed resources

Developer Experience

• Configuration UI: Enhanced Project Settings with presence configuration options
• Platform Detection: Automatic platform detection with sensible defaults
• Debugging Support: Comprehensive logging and connection statistics for troubleshooting
• Backward Compatibility: All existing APIs remain unchanged; new features are additive

🚀 API Changes

New Public APIs

// Presence System
LootLockerSDKManager.StartPresence(onConnectionStateChanged, onMessageReceived);
LootLockerSDKManager.UpdatePresenceStatus("online", metadata);
LootLockerSDKManager.GetPresenceConnectionState();
LootLockerSDKManager.IsPresenceConnected();

// Event System  
LootLockerEventSystem.Subscribe<LootLockerSessionStartedEventData>(eventType, handler);
LootLockerEventSystem.TriggerEvent(eventData);

// SDK Management
LootLockerSDKManager.ResetSDK(); // New coordinated reset method

Enhanced APIs

• All authentication methods now trigger session lifecycle events
• Improved error handling across all HTTP operations
• Enhanced service initialization with proper dependency management

🔧 Breaking Changes

None - This PR is designed to be fully backward compatible. All existing APIs continue to work exactly as before.

🧪 Testing Considerations

Service Lifecycle

• Services initialize in correct dependency order
• Service reset functionality works correctly
• Application lifecycle events are properly handled
• Memory leaks prevented through proper cleanup

Presence System

• WebSocket connections establish successfully
• Automatic reconnection works on connection failures
• Mobile battery optimizations function correctly
• Multi-session presence connections work independently

Event System

• Session events fire correctly for all authentication flows
• Event subscriptions and unsubscriptions work properly
• Weak references prevent memory leaks
• Thread-safe event processing

📱 Platform Support

Presence Platform Matrix

Configuration

Presence can be configured in Project Settings > LootLocker SDK > Presence Settings with platform-specific toggles and battery optimization options.

📋 Commit Structure

This PR includes 7 atomic commits for easier review:

1. LootLockerLifecycleManager - Core service management foundation
2. RateLimiter Service Conversion - Service architecture implementation
3. HTTPClient Integration - Performance optimizations and service integration
4. Event System - Centralized event management
5. Presence System - WebSocket presence functionality
6. SDK Manager Integration - API integration and authentication flow updates
7. Editor Integration - Editor extensions and cleanup

🔍 Review Notes

• Each commit can be reviewed independently
• Service architecture follows established Unity patterns
• All new code includes comprehensive documentation
• Performance improvements are measurable (cached service references)
• Memory safety is prioritized throughout (weak references, proper disposal)

🚀 Migration Guide

For Existing Users

No migration required - all existing code continues to work unchanged.

For New Presence Features

// Enable presence in Project Settings, then:
LootLockerSDKManager.StartPresence(
    onConnectionStateChanged: (playerUlid, state, error) => {
        Debug.Log($"Presence state: {state}");
    },
    onMessageReceived: (playerUlid, message, type) => {
        Debug.Log($"Presence message: {message}");
    }
);

For Event System

// Subscribe to session events:
LootLockerEventSystem.Subscribe<LootLockerSessionStartedEventData>(
    LootLockerEventType.SessionStarted,
    OnSessionStarted
);

private void OnSessionStarted(LootLockerSessionStartedEventData eventData) {
    Debug.Log($"Session started for {eventData.playerData.ULID}");
}

✅ Checklist

• All existing functionality preserved
• Comprehensive documentation added
• Performance optimizations implemented
• Memory safety ensured
• Platform compatibility maintained
• Editor integration complete
• Atomic commits for easy review

This PR establishes a solid foundation for future SDK enhancements while adding powerful real-time capabilities that developers have been requesting.